home *** CD-ROM | disk | FTP | other *** search
/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / a_utils / _archvrs / amiga / unsit15c.lzh / unsit1.5c.amiga / docs / unsit.1 < prev   
Text File  |  1991-09-07  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4. UNSIT(L)            UNIX Programmer's Manual             UNSIT(L)
  5.  
  6.  
  7.  
  8. NAME
  9.      unsit - extract/list files in a Macintosh Stuffit archive
  10.      file
  11.  
  12. SYNOPSIS
  13.      unsit [ -dflmqruv ] file
  14.  
  15. DESCRIPTION
  16.      For the Stuffit archive file listed, unsit extracts the
  17.      files in the archive into separate files.  This makes it
  18.      possible, for example, to separate a large StuffIt file into
  19.      component files for selective downloading, rather than down-
  20.      loading the larger archive file just to extract a single,
  21.      small file.  It also allows the use of StuffIt to compress a
  22.      group of files into a single, smaller archive that can be
  23.      uploaded to a Unix system for storage, printing, etc.
  24.  
  25.      In the normal mode, both the data and the resource forks of
  26.      the component Macintosh files in the archive are extracted
  27.      and stored in Unix files with the extension .data and .rsrc
  28.      appended to the end of the Macintosh file name.  In addi-
  29.      tion, a .info file will be created with the Finder informa-
  30.      tion.  These three file are compatible with the macput pro-
  31.      gram for downloading to a Mac running Macterminal.  If only
  32.      the data or resource fork is extracted, no addition exten-
  33.      sion is appended to the Mac file name.  Characters in the
  34.      Mac file name that are illegal (or unwieldy, like spaces)
  35.      are changed to underscores in the Unix file name.  The true
  36.      Mac file name is retained in the .info file and is restored
  37.      when the file is downloaded.
  38.  
  39.      StuffIt version 1.5 has the ability to archive a group of
  40.      files and folders in such a way that the hierarchical rela-
  41.      tionship of the files and folders is maintained.  Unsit ver-
  42.      sion 1.5 can unpack files archived in this manner and place
  43.      them in corresponding subdirectories so as to maintain the
  44.      hierarchy.  As an option, the hierarcy can be flattened out
  45.      and all the files stored in the current directory.
  46.  
  47.      The options are similar to those for macput and unpit.
  48.  
  49.      -f   For StuffIt files containing a "Hierarchy Maintained
  50.           Folder" entry, extract the files into a "flat" organi-
  51.           zation (all in the current directory) rather than main-
  52.           taining the hierarchy by creating new directories, etc.
  53.           Default is to maintain the hierarchical folder organi-
  54.           zation.
  55.  
  56.      -l   List the files in the archive but do not extract them.
  57.           The name, size, type, and creator of each file is
  58.           listed.
  59.  
  60.  
  61.  
  62.  
  63. Printed 8/10/91        Septermber 28, 1988                      1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. UNSIT(L)            UNIX Programmer's Manual             UNSIT(L)
  71.  
  72.  
  73.  
  74.      -m   Assumes the input file in MacBinary format rather than
  75.           macput/macget format and skips over the MacBinary
  76.           header.
  77.  
  78.      -r   Extract resources forks only.
  79.  
  80.      -d   Extract data forks only.
  81.  
  82.      -u   Extract data fork and change into a Unix text file.
  83.           This only works if the file is really a text file.
  84.  
  85.      -q   Query user before extracting files and folders.  If a
  86.           "n" answer is given for a folder, none of the files or
  87.           folders in that folder will be extracted.
  88.  
  89.      -v   Verbose option.  Causes unsit to list name, size, type,
  90.           and creator of each file extracted.
  91.  
  92. BUGS
  93.      Files that were compressed by StuffIt with the Lempel-Ziv
  94.      method and are extracted with the -u switch (text files) are
  95.      not checked for a correct CRC value when unsit uncompresses
  96.      them.  This is because unsit pipes the data through compress
  97.      and tr to extract the file and never has a chance to do the
  98.      CRC check.
  99.  
  100.      The compress program has been observed to go into strange
  101.      states when uncompressing a damaged file.  Often it will get
  102.      stuck writing out bogus data until the disk fills up.  Since
  103.      unsit sends data through compress, the same problem could
  104.      occur when extracting files from a damaged Stuffit archive.
  105.  
  106. FILES
  107.      For archives that have been compressed with the Lempel-Ziv
  108.      method, the compress program must be present on the system
  109.      and in the search path since unsit uses it for the
  110.      uncompressing.  Compress is available from the
  111.      comp.sources.unix archives.
  112.  
  113. AUTHOR
  114.      Allan G. Weber (weber%brand.usc.edu@oberon.usc.edu)
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Printed 8/10/91        Septermber 28, 1988                      2
  130.  
  131.  
  132.  
  133.